home *** CD-ROM | disk | FTP | other *** search
/ MacWorld Secrets (4th Edition) / Mac Secrets CD 4th Ed.toast / Apple Advanced Technologies / Apple Speech Technologies 1.5 / PlainTalk Developer Info / Speech Recognition Manager SDK / SR Sample Code / Speakable Items Example / Sources / Speech Recognition Toolbox API / SpeechRecognition.h next >
Text File  |  1996-04-22  |  20KB  |  473 lines
  1. /*
  2.      File:        SpeechRecognition.h
  3.  
  4.      Contains:    Apple Speech Recognition Toolbox Interfaces.
  5.  
  6.      Version:    Technology:    PlainTalk 1.5
  7.  
  8.                  Release:    PlainTalk Developer Release
  9.  
  10.      Copyright:    © 1984-1996 by Apple Computer, Inc.
  11.  
  12.                  All rights reserved.
  13.  
  14.      Bugs?:        If you find a problem with this file, send the file and version
  15.                  information (from above) and the problem description to:
  16.  
  17.                      Internet:    apple.bugs@applelink.apple.com
  18.                      AppleLink:    APPLE.BUGS
  19.  
  20. */
  21. #ifndef __SPEECHRECOGNITION__
  22. #define __SPEECHRECOGNITION__
  23.  
  24. #ifndef __MEMORY__
  25. #include <Memory.h>
  26. #endif
  27.  
  28. #ifdef __cplusplus
  29. extern "C" {
  30. #endif
  31.  
  32. #if PRAGMA_IMPORT_SUPPORTED
  33. #pragma import on
  34. #endif
  35.  
  36. #if PRAGMA_ALIGN_SUPPORTED
  37. #pragma options align=mac68k
  38. #endif
  39.  
  40.  
  41. enum {
  42.     gestaltSpeechRecognitionVersion = 'srtb',
  43.     gestaltSpeechRecognitionAttr = 'srta'
  44. };
  45.  
  46.  
  47. enum {
  48.     gestaltDesktopSpeechRecognition = 1L << 0,
  49.     gestaltTelephoneSpeechRecognition = 1L << 1
  50. };
  51.  
  52. /* Error Codes [Speech recognition gets -5100 through -5199] */
  53.  
  54. enum {
  55.     kSRNotAvailable                = -5100,                        /* the service requested is not avail or applicable */
  56.     kSRInternalError            = -5101,                        /* a system internal or hardware error condition */
  57.     kSRComponentNotFound        = -5102,                        /* a needed system resource was not located */
  58.     kSROutOfMemory                = -5103,                        /* an out of memory error occurred in the toolbox memory space */
  59.     kSRNotASpeechObject            = -5104,                        /* the object specified is no longer or never was valid */
  60.     kSRBadParameter                = -5105,                        /* an invalid parameter was specified */
  61.     kSRParamOutOfRange            = -5106,                        /* when we say 0-100, don't pass in 101. */
  62.     kSRBadSelector                = -5107,                        /* an unrecognized selector was specified */
  63.     kSRBufferTooSmall            = -5108,                        /* returned from attribute access functions */
  64.     kSRNotARecSystem            = -5109,                        /* the object used was not a SRRecognitionSystem */
  65.     kSRFeedbackNotAvail            = -5110,                        /* there is no feedback window associated with SRRecognizer */
  66.     kSRCantSetProperty            = -5111,                        /* a non-settable property was specified */
  67.     kSRCantGetProperty            = -5112,                        /* a non-gettable property was specified */
  68.     kSRCantSetDuringRecognition    = -5113,                        /* the property can't be set while recognition is in progress -- do before or between utterances. */
  69.     kSRAlreadyListening            = -5114,                        /* in response to SRStartListening */
  70.     kSRNotListeningState        = -5115,                        /* in response to SRStopListening */
  71.     kSRModelMismatch            = -5116,                        /* no acoustical models are avail to match request */
  72.     kSRNoClientLanguageModel    = -5117,                        /* trying to access a non-specified SRLanguageModel */
  73.     kSRNoPendingUtterances        = -5118,                        /* nothing to continue search on */
  74.     kSRRecognitionCanceled        = -5119,                        /* an abort error occurred during search */
  75.     kSRRecognitionDone            = -5120,                        /* search has finished, but nothing was recognized */
  76.     kSROtherRecAlreadyModal        = -5121,                        /* another recognizer is modal at the moment, so can't set this recognizer's kSRBlockModally property right now */
  77.     kSRHasNoSubItems            = -5122,                        /* SRCountItems or related routine was called on an object without subelements -- e.g. a word -- rather than phrase, path, or LM. */
  78.     kSRSubItemNotFound            = -5123,                        /* returned when accessing a non-existent sub item of a container */
  79.     kSRLanguageModelTooBig        = -5124,                        /* Cant build language models so big */
  80.     kSRAlreadyReleased            = -5125,                        /* this object has already been released before */
  81.     kSRAlreadyFinished            = -5126,                        /* the language model can't be finished twice */
  82.     kSRWordNotFound                = -5127,                        /* the spelling couldn't be found in lookup(s) */
  83.     kSRNotFinishedWithRejection    = -5128,                        /* property not found because the LMObj is not finished with rejection */
  84.     kSRExpansionTooDeep            = -5129,                        /* Language model is left recursive or is embedded too many levels */
  85.     kSRTooManyElements            = -5130,                        /* Too many elements added to phrase or path or other langauge model object */
  86.     kSRCantAdd                    = -5131,                        /* Can't add given type of object to the base SRLanguageObject (e.g.in SRAddLanguageObject)    */
  87.     kSRSndInSourceDisconnected    = -5132,                        /* Sound input source is disconnected */
  88.     kSRCantReadLanguageObject    = -5133,                        /* An error while trying to create new Language object from file or pointer -- possibly bad format */
  89.                                                                 /* non-release debugging error codes are included here */
  90.     kSRNotImplementedYet        = -5199                            /* you'd better wait for this feature in a future release */
  91. };
  92.  
  93. /* Type Definitions */
  94. typedef struct OpaqueSRSpeechObject* SRSpeechObject;
  95. typedef SRSpeechObject SRRecognitionSystem;
  96. typedef SRSpeechObject SRRecognizer;
  97. typedef SRSpeechObject SRSpeechSource;
  98. typedef SRSpeechSource SRRecognitionResult;
  99. typedef SRSpeechObject SRLanguageObject;
  100. typedef SRLanguageObject SRLanguageModel;
  101. typedef SRLanguageObject SRPath;
  102. typedef SRLanguageObject SRPhrase;
  103. typedef SRLanguageObject SRWord;
  104. /* between 0 and 100 */
  105. typedef unsigned short SRSpeedSetting;
  106. /* between 0 and 100 */
  107. typedef unsigned short SRRejectionLevel;
  108. /* When an event occurs, the user supplied proc will be called with a pointer    */
  109. /*    to the param passed in and a flag to indicate conditions such                */
  110. /*    as interrupt time or system background time.                                */
  111. struct SRCallBackStruct {
  112.     long                             what;                        /* one of notification flags */
  113.     long                             message;                    /* contains SRRecognitionResult id */
  114.     SRRecognizer                     instance;                    /* ID of recognizer being notified */
  115.     OSErr                             status;                        /* result status of last search */
  116.     short                             flags;                        /* non-zero if occurs during interrupt */
  117.     long                             refCon;                        /* user defined - set from SRCallBackParam */
  118. };
  119. typedef struct SRCallBackStruct SRCallBackStruct;
  120.  
  121. /* Call back procedure definition */
  122. typedef pascal void (*SRCallBackProcPtr)(SRCallBackStruct *param);
  123.  
  124. #if GENERATINGCFM
  125. typedef UniversalProcPtr SRCallBackUPP;
  126. #else
  127. typedef SRCallBackProcPtr SRCallBackUPP;
  128. #endif
  129.  
  130. enum {
  131.     uppSRCallBackProcInfo = kPascalStackBased
  132.          | STACK_ROUTINE_PARAMETER(1, SIZE_CODE(sizeof(SRCallBackStruct *)))
  133. };
  134.  
  135. #if GENERATINGCFM
  136. #define NewSRCallBackProc(userRoutine)        \
  137.         (SRCallBackUPP) NewRoutineDescriptor((ProcPtr)(userRoutine), uppSRCallBackProcInfo, GetCurrentArchitecture())
  138. #else
  139. #define NewSRCallBackProc(userRoutine)        \
  140.         ((SRCallBackUPP) (userRoutine))
  141. #endif
  142.  
  143. #if GENERATINGCFM
  144. #define CallSRCallBackProc(userRoutine, param)        \
  145.         CallUniversalProc((UniversalProcPtr)(userRoutine), uppSRCallBackProcInfo, (param))
  146. #else
  147. #define CallSRCallBackProc(userRoutine, param)        \
  148.         (*(userRoutine))((param))
  149. #endif
  150. struct SRCallBackParam {
  151.     SRCallBackUPP                     callBack;
  152.     long                             refCon;
  153. };
  154. typedef struct SRCallBackParam SRCallBackParam;
  155.  
  156. /* Recognition System Types */
  157.  
  158. enum {
  159.     kSRDefaultRecognitionSystemID = 0
  160. };
  161.  
  162. /* Recognition System Properties */
  163.  
  164. enum {
  165.     kSRFeedbackAndListeningModes = 'fbwn',                        /* short: one of kSRNoFeedbackHasListenModes, kSRHasFeedbackHasListenModes, kSRNoFeedbackNoListenModes */
  166.     kSRRejectedWord                = 'rejq',                        /* the SRWord used to represent a rejection */
  167.     kSRCleanupOnClientExit        = 'clup'                        /* Boolean: Default is true. The rec system and everything it owns is disposed when the client application quits */
  168. };
  169.  
  170.  
  171. enum {
  172.     kSRNoFeedbackNoListenModes    = 0,                            /* next allocated recognizer has no feedback window and doesn't use listening modes    */
  173.     kSRHasFeedbackHasListenModes = 1,                            /* next allocated recognizer has feedback window and uses listening modes             */
  174.     kSRNoFeedbackHasListenModes    = 2                                /* next allocated recognizer has no feedback window but does use listening modes     */
  175. };
  176.  
  177. /* Speech Source Types */
  178.  
  179. enum {
  180.     kSRDefaultSpeechSource        = 0,
  181.     kSRLiveDesktopSpeechSource    = 'dklv',                        /* live desktop sound input */
  182.     kSRCanned22kHzSpeechSource    = 'ca22'                        /* AIFF file based 16 bit, 22.050 KHz sound input */
  183. };
  184.  
  185. /* Notification via Apple Event or Callback */
  186. /* Notification Flags */
  187.  
  188. enum {
  189.     kSRNotifyRecognitionBeginning = 1L << 0,                    /* recognition can begin. client must now call SRContinueRecognition or SRCancelRecognition */
  190.     kSRNotifyRecognitionDone    = 1L << 1                        /* recognition has terminated. result (if any) is available. */
  191. };
  192.  
  193. /* Apple Event selectors */
  194. /* AppleEvent message class  */
  195.  
  196. enum {
  197.     kAESpeechSuite                = 'sprc'
  198. };
  199.  
  200. /* AppleEvent message event ids */
  201.  
  202. enum {
  203.     kAESpeechDone                = 'srsd',
  204.     kAESpeechDetected            = 'srbd'
  205. };
  206.  
  207. /* AppleEvent Parameter ids */
  208.  
  209. enum {
  210.     keySRRecognizer                = 'krec',
  211.     keySRSpeechResult            = 'kspr',
  212.     keySRSpeechStatus            = 'ksst'
  213. };
  214.  
  215. /* AppleEvent Parameter types */
  216.  
  217. enum {
  218.     typeSRRecognizer            = 'trec',
  219.     typeSRSpeechResult            = 'tspr'
  220. };
  221.  
  222. /* SRRecognizer Properties */
  223.  
  224. enum {
  225.     kSRNotificationParam        = 'noti',                        /* see notification flags below */
  226.     kSRCallBackParam            = 'call',                        /* type SRCallBackParam */
  227.     kSRSearchStatusParam        = 'stat',                        /* see status flags below */
  228.     kSRAutoFinishingParam        = 'afin',                        /* automatic finishing applied on LM for search */
  229.     kSRForegroundOnly            = 'fgon',                        /* Boolean. Default is true. If true, client recognizer only active when in foreground.    */
  230.     kSRBlockBackground            = 'blbg',                        /* Boolean. Default is false. If true, when client recognizer in foreground, rest of LMs are inactive.    */
  231.     kSRBlockModally                = 'blmd',                        /* Boolean. Default is false. When true, this client's LM is only active LM; all other LMs are inactive. Be nice, don't be modal for long periods! */
  232.     kSRWantsResultTextDrawn        = 'txfb',                        /* Boolean. Default is true. If true, search results are posted to Feedback window */
  233.     kSRWantsAutoFBGestures        = 'dfbr',                        /* Boolean. Default is true. If true, client needn't call SRProcessBegin/End to get default feedback behavior */
  234.     kSRSoundInVolume            = 'volu',                        /* short in [0..100] log scaled sound input power. Can't set this property */
  235.     kSRReadAudioFSSpec            = 'aurd',                        /* *FSSpec. Specify FSSpec where raw audio is to be read (AIFF format) using kSRCanned22kHzSpeechSource. Reads until EOF */
  236.     kSRCancelOnSoundOut            = 'caso',                        /* Boolean: Default is true.  If any sound is played out during utterance, recognition is aborted. */
  237.     kSRSpeedVsAccuracyParam        = 'sped'                        /* SRSpeedSetting between 0 and 100 */
  238. };
  239.  
  240. /* 0 means more accurate but slower. */
  241. /* 100 means (much) less accurate but faster. */
  242.  
  243. enum {
  244.     kSRUseToggleListen            = 0,                            /* listen key modes */
  245.     kSRUsePushToTalk            = 1
  246. };
  247.  
  248.  
  249. enum {
  250.     kSRListenKeyMode            = 'lkmd',                        /* short: either kSRUseToggleListen or kSRUsePushToTalk */
  251.     kSRListenKeyCombo            = 'lkey',                        /* short: Push-To-Talk key combination; high byte is high byte of event->modifiers, the low byte is the keycode from event->message */
  252.     kSRListenKeyName            = 'lnam',                        /* Str63: string representing ListenKeyCombo */
  253.     kSRKeyWord                    = 'kwrd',                        /* Str255: keyword preceding spoken commands in kSRUseToggleListen mode */
  254.     kSRKeyExpected                = 'kexp'                        /* Boolean: Must the PTT key be depressed or the key word spoken before recognition can occur? */
  255. };
  256.  
  257. /* Operational Status Flags */
  258.  
  259. enum {
  260.     kSRIdleRecognizer            = 1L << 0,                        /* engine is not active */
  261.     kSRSearchInProgress            = 1L << 1,                        /* search is in progress */
  262.     kSRSearchWaitForAllClients    = 1L << 2,                        /* search is suspended waiting on all clients' input */
  263.     kSRMustCancelSearch            = 1L << 3,                        /* something has occurred (sound played, non-speech detected) requiring the search to abort */
  264.     kSRPendingSearch            = 1L << 4                        /* we're about to start searching */
  265. };
  266.  
  267. /* Recognition Result Properties */
  268.  
  269. enum {
  270.     kSRTEXTFormat                = 'TEXT',                        /* raw text in user supplied memory */
  271.     kSRPhraseFormat                = 'lmph',                        /* SRPhrase containing result words */
  272.     kSRPathFormat                = 'lmpt',                        /* SRPath containing result phrases or words */
  273.     kSRLanguageModelFormat        = 'lmfm'                        /* top level SRLanguageModel for post parse */
  274. };
  275.  
  276. /* SRLanguageObject Family Properties */
  277.  
  278. enum {
  279.     kSRSpelling                    = 'spel',                        /* spelling of a SRWord or SRPhrase or SRPath, or name of a SRLanguageModel */
  280.     kSRLMObjType                = 'lmtp',                        /* Returns one of SRLanguageObject Types listed below */
  281.     kSRRefCon                    = 'refc',                        /* 4 bytes of user storage */
  282.     kSROptional                    = 'optl',                        /* Boolean -- true if SRLanguageObject is optional    */
  283.     kSREnabled                    = 'enbl',                        /* Boolean -- true if SRLanguageObject enabled */
  284.     kSRRepeatable                = 'rptb',                        /* Boolean -- true if SRLanguageObject is repeatable */
  285.     kSRRejectable                = 'rjbl',                        /* Boolean -- true if SRLanguageObject is rejectable (Recognition System's kSRRejectedWord */
  286.                                                                 /*        object can be returned in place of SRLanguageObject with this property)    */
  287.     kSRRejectionLevel            = 'rjct'                        /* SRRejectionLevel between 0 and 100 */
  288. };
  289.  
  290. /* LM Object Types -- returned as kSRLMObjType property of language model objects */
  291.  
  292. enum {
  293.     kSRLanguageModelType        = 'lmob',                        /* SRLanguageModel */
  294.     kSRPathType                    = 'path',                        /* SRPath */
  295.     kSRPhraseType                = 'phra',                        /* SRPhrase */
  296.     kSRWordType                    = 'word'                        /* SRWord */
  297. };
  298.  
  299. /* a normal and reasonable rejection level */
  300.  
  301. enum {
  302.     kSRDefaultRejectionLevel    = 50
  303. };
  304.  
  305. /********************************************************************************/
  306. /*                        NOTES ON USING THE API                                    */
  307. /*                                                                                */
  308. /*        All operations (with the exception of SRGetRecognitionSystem) are        */
  309. /*        directed toward an object allocated or begot from New, Get and Read        */
  310. /*        type calls.                                                                */
  311. /*                                                                                */
  312. /*        There is a simple rule in dealing with allocation and disposal:            */
  313. /*                                                                                */
  314. /*        *    all toolbox allocations are obtained from a SRRecognitionSystem        */
  315. /*                                                                                */
  316. /*        *    if you obtain an object via New or Get, then you own a reference     */
  317. /*            to that object and it must be released via SRReleaseObject when        */
  318. /*            you no longer need it                                                */
  319. /*                                                                                */
  320. /*        *    when you receive a SRRecognitionResult object via AppleEvent or        */
  321. /*            callback, it has essentially been created on your behalf and so        */
  322. /*            you are responsible for releasing it as above                        */
  323. /*                                                                                */
  324. /*        *    when you close a SRRecognitionSystem, all remaining objects which        */
  325. /*            were allocated with it will be forcefully released and any            */
  326. /*            remaining references to those objects will be invalid.                */
  327. /*                                                                                */
  328. /*        This translates into a very simple guideline:                            */
  329. /*            If you allocate it or have it allocated for you, you must release    */
  330. /*            it.  If you are only peeking at it, then don't release it.            */
  331. /*                                                                                */
  332. /********************************************************************************/
  333. /* Opening and Closing of the SRRecognitionSystem */
  334. extern pascal OSErr SROpenRecognitionSystem(SRRecognitionSystem *system, OSType systemID)
  335.  THREEWORDINLINE(0x303C, 0x0400, 0xAA56);
  336.  
  337. extern pascal OSErr SRCloseRecognitionSystem(SRRecognitionSystem system)
  338.  THREEWORDINLINE(0x303C, 0x0201, 0xAA56);
  339.  
  340. /* Accessing Properties of any Speech Object */
  341. extern pascal OSErr SRSetProperty(SRSpeechObject srObject, OSType selector, const void *property, Size propertyLen)
  342.  THREEWORDINLINE(0x303C, 0x0802, 0xAA56);
  343.  
  344. extern pascal OSErr SRGetProperty(SRSpeechObject srObject, OSType selector, void *property, Size *propertyLen)
  345.  THREEWORDINLINE(0x303C, 0x0803, 0xAA56);
  346.  
  347. /* Any object obtained via New or Get type calls must be released */
  348. extern pascal OSErr SRReleaseObject(SRSpeechObject srObject)
  349.  THREEWORDINLINE(0x303C, 0x0204, 0xAA56);
  350.  
  351. extern pascal OSErr SRGetReference(SRSpeechObject srObject, SRSpeechObject *newObjectRef)
  352.  THREEWORDINLINE(0x303C, 0x0425, 0xAA56);
  353.  
  354. /* SRRecognizer Instance Functions */
  355. extern pascal OSErr SRNewRecognizer(SRRecognitionSystem system, SRRecognizer *recognizer, OSType sourceID)
  356.  THREEWORDINLINE(0x303C, 0x060A, 0xAA56);
  357.  
  358. extern pascal OSErr SRStartListening(SRRecognizer recognizer)
  359.  THREEWORDINLINE(0x303C, 0x020C, 0xAA56);
  360.  
  361. extern pascal OSErr SRStopListening(SRRecognizer recognizer)
  362.  THREEWORDINLINE(0x303C, 0x020D, 0xAA56);
  363.  
  364. extern pascal OSErr SRSetLanguageModel(SRRecognizer recognizer, SRLanguageModel languageModel)
  365.  THREEWORDINLINE(0x303C, 0x040E, 0xAA56);
  366.  
  367. extern pascal OSErr SRGetLanguageModel(SRRecognizer recognizer, SRLanguageModel *languageModel)
  368.  THREEWORDINLINE(0x303C, 0x040F, 0xAA56);
  369.  
  370. extern pascal OSErr SRContinueRecognition(SRRecognizer recognizer)
  371.  THREEWORDINLINE(0x303C, 0x0210, 0xAA56);
  372.  
  373. extern pascal OSErr SRCancelRecognition(SRRecognizer recognizer)
  374.  THREEWORDINLINE(0x303C, 0x0211, 0xAA56);
  375.  
  376. extern pascal OSErr SRIdle(void )
  377.  THREEWORDINLINE(0x303C, 0x0028, 0xAA56);
  378.  
  379. /* Language Model Building and Manipulation Functions */
  380. extern pascal OSErr SRNewLanguageModel(SRRecognitionSystem system, SRLanguageModel *model, const void *name, Size nameLength)
  381.  THREEWORDINLINE(0x303C, 0x0812, 0xAA56);
  382.  
  383. extern pascal OSErr SRNewPath(SRRecognitionSystem system, SRPath *path)
  384.  THREEWORDINLINE(0x303C, 0x0413, 0xAA56);
  385.  
  386. extern pascal OSErr SRNewPhrase(SRRecognitionSystem system, SRPhrase *phrase, const void *text, Size textLength)
  387.  THREEWORDINLINE(0x303C, 0x0814, 0xAA56);
  388.  
  389. extern pascal OSErr SRNewWord(SRRecognitionSystem system, SRWord *word, const void *text, Size textLength)
  390.  THREEWORDINLINE(0x303C, 0x0815, 0xAA56);
  391.  
  392. /* Operations on any object of the SRLanguageObject family */
  393. extern pascal OSErr SRPutLanguageObjectIntoHandle(SRLanguageObject languageObject, Handle lobjHandle)
  394.  THREEWORDINLINE(0x303C, 0x0416, 0xAA56);
  395.  
  396. extern pascal OSErr SRPutLanguageObjectIntoDataFile(SRLanguageObject languageObject, short fRefNum)
  397.  THREEWORDINLINE(0x303C, 0x0328, 0xAA56);
  398.  
  399. extern pascal OSErr SRNewLanguageObjectFromHandle(SRRecognitionSystem system, SRLanguageObject *languageObject, Handle lObjHandle)
  400.  THREEWORDINLINE(0x303C, 0x0417, 0xAA56);
  401.  
  402. extern pascal OSErr SRNewLanguageObjectFromDataFile(SRRecognitionSystem system, SRLanguageObject *languageObject, short fRefNum)
  403.  THREEWORDINLINE(0x303C, 0x0427, 0xAA56);
  404.  
  405. extern pascal OSErr SREmptyLanguageObject(SRLanguageObject languageObject)
  406.  THREEWORDINLINE(0x303C, 0x0218, 0xAA56);
  407.  
  408. extern pascal OSErr SRChangeLanguageObject(SRLanguageObject languageObject, const void *text, Size textLength)
  409.  THREEWORDINLINE(0x303C, 0x0619, 0xAA56);
  410.  
  411. extern pascal OSErr SRAddLanguageObject(SRLanguageObject base, SRLanguageObject addon)
  412.  THREEWORDINLINE(0x303C, 0x041A, 0xAA56);
  413.  
  414. extern pascal OSErr SRAddText(SRLanguageObject base, const void *text, Size textLength, long refCon)
  415.  THREEWORDINLINE(0x303C, 0x081B, 0xAA56);
  416.  
  417. extern pascal OSErr SRRemoveLanguageObject(SRLanguageObject base, SRLanguageObject toRemove)
  418.  THREEWORDINLINE(0x303C, 0x041C, 0xAA56);
  419.  
  420. /* Traversing SRRecognitionResults or SRLanguageObjects */
  421. extern pascal OSErr SRCountItems(SRSpeechObject container, long *count)
  422.  THREEWORDINLINE(0x303C, 0x0405, 0xAA56);
  423.  
  424. extern pascal OSErr SRGetIndexedItem(SRSpeechObject container, SRSpeechObject *item, long index)
  425.  THREEWORDINLINE(0x303C, 0x0606, 0xAA56);
  426.  
  427. extern pascal OSErr SRSetIndexedItem(SRSpeechObject container, SRSpeechObject item, long index)
  428.  THREEWORDINLINE(0x303C, 0x0607, 0xAA56);
  429.  
  430. extern pascal OSErr SRRemoveIndexedItem(SRSpeechObject container, long index)
  431.  THREEWORDINLINE(0x303C, 0x0408, 0xAA56);
  432.  
  433. /* Utilizing the System Feedback Window */
  434. extern pascal OSErr SRDrawText(SRRecognizer recognizer, const void *dispText, Size dispLength)
  435.  THREEWORDINLINE(0x303C, 0x0621, 0xAA56);
  436.  
  437. extern pascal OSErr SRDrawRecognizedText(SRRecognizer recognizer, const void *dispText, Size dispLength)
  438.  THREEWORDINLINE(0x303C, 0x0622, 0xAA56);
  439.  
  440. extern pascal OSErr SRSpeakText(SRRecognizer recognizer, const void *speakText, Size speakLength)
  441.  THREEWORDINLINE(0x303C, 0x0620, 0xAA56);
  442.  
  443. extern pascal OSErr SRSpeakAndDrawText(SRRecognizer recognizer, const void *text, Size textLength)
  444.  THREEWORDINLINE(0x303C, 0x061F, 0xAA56);
  445.  
  446. extern pascal OSErr SRStopSpeech(SRRecognizer recognizer)
  447.  THREEWORDINLINE(0x303C, 0x0223, 0xAA56);
  448.  
  449. extern pascal Boolean SRSpeechBusy(SRRecognizer recognizer)
  450.  THREEWORDINLINE(0x303C, 0x0224, 0xAA56);
  451.  
  452. extern pascal OSErr SRProcessBegin(SRRecognizer recognizer, Boolean failed)
  453.  THREEWORDINLINE(0x303C, 0x031D, 0xAA56);
  454.  
  455. extern pascal OSErr SRProcessEnd(SRRecognizer recognizer, Boolean failed)
  456.  THREEWORDINLINE(0x303C, 0x031E, 0xAA56);
  457.  
  458.  
  459. #if PRAGMA_ALIGN_SUPPORTED
  460. #pragma options align=reset
  461. #endif
  462.  
  463. #if PRAGMA_IMPORT_SUPPORTED
  464. #pragma import off
  465. #endif
  466.  
  467. #ifdef __cplusplus
  468. }
  469. #endif
  470.  
  471. #endif /* __SPEECHRECOGNITION__ */
  472.  
  473.